From 30cdab13fe62884457b7c1c35142386e453adfd0 Mon Sep 17 00:00:00 2001 From: =?utf8?q?Javier=20Jard=C3=B3n?= Date: Fri, 24 Dec 2010 14:39:55 +0100 Subject: [PATCH] docs: Add docs about how to get a GtkDevice Fixes https://bugzilla.gnome.org/show_bug.cgi?id=637895 --- gdk/gdkdevice.c | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/gdk/gdkdevice.c b/gdk/gdkdevice.c index cc375d7b54..54cb7fac6e 100644 --- a/gdk/gdkdevice.c +++ b/gdk/gdkdevice.c @@ -1044,7 +1044,10 @@ get_native_grab_event_mask (GdkEventMask grab_mask) /** * gdk_device_grab: - * @device: a #GdkDevice + * @device: a #GdkDevice. To get the device you can use gtk_get_current_event_device() + * or gdk_event_get_device() if the grab is in reaction to an event. Also, you can use + * gdk_device_manager_get_client_pointer() but only in code that isn't triggered by a + * #GdkEvent and there aren't other means to get a meaningful #GdkDevice to operate on. * @window: the #GdkWindow which will own the grab (the grab window) * @grab_ownership: specifies the grab ownership. * @owner_events: if %FALSE then all device events are reported with respect to -- 2.30.2